home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / door / avb23.zip / AVB.DOC < prev    next >
Text File  |  1992-11-27  |  13KB  |  327 lines
  1.  
  2.                        ============================
  3.                            The ANSI Voting Booth
  4.                        ============================
  5.                           (c)1991,92 T&J Software
  6.  
  7.          One of the T&J Software Collection of multi-BBS door programs.
  8.            Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
  9.               UltraBBS, Telegard, TriBBS, Remote Access, and WWIV
  10.  
  11.  
  12.                         VERSION 2.30     11/27/92
  13.  
  14.                                     By
  15.  
  16.                                Tom Wildoner
  17.                              397 West Broadway
  18.                               Jim Thorpe, PA
  19.                                   18229
  20.                             VOICE (717)325-9480
  21.  
  22.                                    From
  23.  
  24.                                 The T&J BBS
  25.                                (717)325-9481
  26.                          1200/2400/9600/19200/38400
  27.                                24 Hours/Day
  28.  
  29.  
  30. LATEST VERSION:
  31. Please call the T&J BBS for the latest version of this program.
  32.  
  33. LEGALITIES:
  34.  
  35.       THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"
  36.       WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
  37.       LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  38.       FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH
  39.       THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT,
  40.       SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF
  41.       OR BREACH OF ANY WARRANTY.
  42.  
  43. Distribution:
  44.  
  45.    You may make this file available for downloading from your BBS or you may
  46.    upload it to any BBS of your choice, provided that you do not make any
  47.    changes to the contents of the archive (ZIP file). The archive and its
  48.    individual contents may not be used by any service that charges any money
  49.    whatsoever, without the written permission of the author.
  50.  
  51. Benefits:
  52.          -- Support for COM1-4 and non-standard port definitions
  53.          -- Online CHAT
  54.          -- Multinode support (DesqView aware)
  55.          -- Colorful ANSI screens
  56.          -- Product support BBS available
  57.          -- Sysop Functions
  58.          -- Easy SETUP!
  59.  
  60. PROGRAM DESCRIPTION:
  61. ===================
  62.  
  63. This is a fairly simple door program -- it allows you, the SysOp, to
  64. setup up to 10 different ANSI screens for your users to vote on. It's
  65. great for online competition between your users! Let your users prepare
  66. ANSI screens, upload them to you, then let the other users vote on their
  67. favorite ANSI screens! Shoot, offer a prize to the winner!
  68.  
  69. NOTE: Some ANSI screens will show better than others. The screens are first
  70. shown on the local screen and then sent to the COM PORT -- so be patient if
  71. the door seems to be hanging (odds are the user is still receiving the
  72. screen, especially for longer animation sequences).
  73.  
  74. Try saving your screens without using a clear screen command. AVB will
  75. automatically clear the screen prior to showing the ANSI screen. If
  76. you use TheDraw, simply save the file using the HOME CURSOR option as
  77. opposed to CLEAR SCREEN.
  78.  
  79.  
  80. NOTE: The voting function is disabled until registered. The KEY that is
  81.       included with the door does not expire!
  82.  
  83.  
  84. INSTALLATION:
  85. ============
  86.  
  87. Example configuration file for PCBOARD.SYS
  88. ------------------------------------------
  89.  
  90. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  91. T&J Software        <=-  (Change this to your BBS name)
  92. Tom                 <=-  (The Sysop's first name)
  93. Wildoner            <=-  (The Sysop's last name)
  94.  
  95. Example configuration file for USERS.SYS
  96. ----------------------------------------
  97.  
  98. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  99. T&J Software        <=-  (Change this to your BBS name)
  100. Tom                 <=-  (The Sysop's first name)
  101. Wildoner            <=-  (The Sysop's last name)
  102.  
  103. Example configuration file for DOOR.SYS
  104. ---------------------------------------
  105.  
  106. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  107. T&J Software        <=-  (Change this to your BBS name)
  108. Tom                 <=-  (The Sysop's first name)
  109. Wildoner            <=-  (The Sysop's last name)
  110.  
  111. Example configuration file for USERINFO.DAT
  112. -------------------------------------------
  113.  
  114. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  115. T&J Software        <=-  (Change this to your BBS name)
  116. Tom                 <=-  (The Sysop's first name)
  117. Wildoner            <=-  (The Sysop's last name)
  118. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  119.  
  120. Example configuration file for CALLINFO.BBS
  121. -------------------------------------------
  122.  
  123. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  124. T&J Software        <=-  (Change this to your BBS name)
  125. Tom                 <=-  (The Sysop's first name)
  126. Wildoner            <=-  (The Sysop's last name)
  127.  
  128. Example configuration file for DORINFOx.DEF
  129. -------------------------------------------
  130.  
  131. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  132.                           where 'x' is the BBS Node number.
  133. T&J Software        <=-  (Change this to your BBS name)
  134. Tom                 <=-  (The Sysop's first name)
  135. Wildoner            <=-  (The Sysop's last name)
  136.  
  137. Example configuration file for SFDOORS.DAT
  138. ------------------------------------------
  139.  
  140. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  141. T&J Software        <=-  (Change this to your BBS name)
  142. Tom                 <=-  (The Sysop's first name)
  143. Wildoner            <=-  (The Sysop's last name)
  144.  
  145. Example configuration file for CHAIN.TXT
  146. ----------------------------------------
  147.  
  148. C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  149. T&J Software        <=-  (Change this to your BBS name)
  150. Tom                 <=-  (The Sysop's first name)
  151. Wildoner            <=-  (The Sysop's last name)
  152.  
  153. Example configuration file for GTUSER.BBS
  154. -----------------------------------------
  155.  
  156. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  157. T&J Software        <=-  (Change this to your BBS name)
  158. Tom                 <=-  (The Sysop's first name)
  159. Wildoner            <=-  (The Sysop's last name)
  160. 1                   <=-  (COM port number - defaults to 1)
  161. 1                   <=-  (Node number - defaults to 1)
  162.  
  163. Example Batch File
  164. ==================
  165.  
  166. A sample batch file is included and is similer to the following:
  167.    ECHO OFF
  168.    CD\DOORS\LEMON           <=- Switch to the door's Directory.
  169.    AVB AVB.CFG              <=- Execute the door program and pass the
  170.                                 configuration filename to the program.
  171.    CD\PCB                   <=- Go back to PCB DIR when user exits door.
  172.    BOARD                    <=- Restart BBS.
  173.  
  174. This Door is multi-node  compatible so you may run more than 1 node from
  175. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  176. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  177. variables, (q.v.)
  178.  
  179. Environment Variables
  180. =====================
  181.  
  182. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  183. variables. Non-PCBoard systems may also use these variables by including
  184. the following in either your BBS batch or AUTOEXEC.BAT
  185.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  186.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  187. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  188. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  189. .CFG file for multi-node operation!
  190.  
  191. To specify a non-standard IRQ, put the IRQ number after the .CFG on the
  192. command line.  For example:
  193.  
  194.      AVB AVB.CFG /5
  195. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  196.      AVB AVB.CFG /%IRQ%
  197.  
  198. This tells the program to use IRQ 5 instead of the standard IRQ.
  199.  
  200.   Had reports of conflicts when using non-standard IRQ's on Novell/Netware
  201.  systems. Seems Novell also uses the / character so something went screwy
  202.  somewhere. So I added the * (asterisk) which may be used instead of the /
  203.  in case of a conflict. In other words, /%IRQ% and *%IRQ% will both work
  204.  and are interchangeable.
  205.  
  206. When specifying the location of the system file on line 1 of the doors .CFG
  207. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  208. and %wcnodeid%. Some examples:
  209.  PCBoard: 
  210.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  211.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  212.  
  213.  Wildcat!:
  214.    USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%
  215.  
  216. Non-PCBoard systems may use the PCB environment variables by setting them
  217. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  218.  SET PCBDRIVE=C:
  219.  SET PCBDIR=\BBSDIR
  220.  SET PCBNODE=1
  221.  
  222. Fossil Driver Support
  223. ---------------------
  224. DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
  225. Fossil driver instead of the standard COM ports, just put /FD on the command
  226. line when running the door. For example:
  227.      MYDOOR MYDOOR.CFG /FD
  228. indicates that a Fossil driver is present and should be used. If no Fossil
  229. driver is detected, DoorFrame will print a message to that effect and exit
  230. the door gracefully.
  231.  
  232.  
  233.  
  234.  
  235. Sysop Keys
  236. ==========
  237.  
  238. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  239.          written to DOOR.SYS and USERS.SYS
  240. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  241.          and/or written to DOOR.SYS and USERS.SYS
  242. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  243. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  244.          and/or written to DOOR.SYS and USERS.SYS
  245. F8    -  Returns the caller involuntarily to the BBS.
  246. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  247.          and/or written to DOOR.SYS and USERS.SYS
  248. F10   -  Activates SysOp CHAT mode within the DOOR.
  249. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  250. UP    -  Give the caller extra time while in the DOOR.  
  251. DN    -  Subtract time from the caller while in the DOOR. 
  252. HOME  -  HELP key for Status Line options.
  253. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  254. ALT-X -  PCBoard will exit after current caller logs off. Value is
  255.          passed to PCBoard. Not available on non-PCBoard systems.
  256.  
  257. Now, add your own screens following the format listed below. Enter all
  258. this information in the SYSOP.CFG file, see the sample one that came with
  259. the door. It would be much easier running AVB using the following
  260. command:   AVB UTILITY
  261.  
  262. This will bring up the utility program and you are offered four choices:
  263.  
  264.     1. Reset the door.
  265.     2. Make your AVB.CFG file
  266.     3. Make your SYSOP.CFG file
  267.     4. QUIT
  268.  
  269. Here is what is contained in the SYSOP.CFG file for those of you who want
  270. to use a text editor:
  271.  
  272.  
  273. 10                                     'Number of screens you have.
  274. screen1.scr                            'DOS filename for first screen.
  275. screen2.scr
  276. screen3.scr                            'All screens must reside in your
  277. screen4.scr                             AVB directory!
  278. screen5.scr
  279. screen6.scr
  280. screen7.scr
  281. screen8.scr
  282. screen9.scr
  283. screen10.scr
  284. Add for Galactic Warzone!              'Description for the first ANSI screen.
  285. Add for T&J Software Support BBS       '40 characters maximum!
  286. Bombing of IRAQ!
  287. Add for US Robotics
  288. What is it like being a SysOp?
  289. Add for Mustang Software BBS
  290. Add for Prize Vault Door game
  291. Add for Lemonade Door game
  292. T&J Software -- most popular files
  293. Eric Erway ANSI screen
  294.  
  295. NOTE: If you do not have 10 ANSI screens to show, you must include blank
  296. spaces for the rest of the entries. Lines 2-11 are the DOS filenames of the
  297. ANSI screens and lines 12-21 are the descriptions. This file must contain
  298. 21 lines.
  299.  
  300.  
  301. To run in LOCAL mode simply run:  AVB LOCAL
  302.  
  303. WHEN YOU CHANGE SCREENS:
  304. ==== === ====== =======
  305. When you switch screens (after you think all the users have had a chance
  306. to vote for the current screens), you can reset the LOG file, the voter
  307. registration file, and the vote total file by running AVB using the
  308. following command:   AVB UTILITY
  309.  
  310. Then select option 1 to reset the records.
  311.  
  312. UPGRADING:
  313. Please erase your old version and set this one up from scratch!
  314.  
  315. FUTURE VERSIONS:
  316. --->> Let me know what you would like to see!
  317.  
  318. VERSION HISTORY:
  319. See the enclosed HISTORY.TXT file.
  320.  
  321. REGISTERING:
  322. That's all there is to it! If you have any problems or questions
  323. please feel free to call the T&J BBS at (717)325-9481 and join the
  324. T&J Software Conference.
  325.  
  326. See the REGISTER.TXT file for information on registering.
  327.